home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / inet / rfc / rfc1231 < prev    next >
Text File  |  1991-05-24  |  52KB  |  1,291 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                      K. McCloghrie
  8. Request for Comments: 1231                      Hughes LAN Systems, Inc.
  9.                                                                   R. Fox
  10.                                                          Synoptics, Inc.
  11.                                                                E. Decker
  12.                                                      cisco Systems, Inc.
  13.                                                                 May 1991
  14.  
  15.  
  16.                        IEEE 802.5 Token Ring MIB
  17.  
  18. Status of this Memo
  19.  
  20.    This memo defines a MIB for 805.5 networks for use with the SNMP
  21.    protocol.  This memo is a product of the Transmission Working Group
  22.    of the Internet Engineering Task Force (IETF).  This RFC specifies an
  23.    IAB standards track protocol for the Internet community, and requests
  24.    discussion and suggestions for improvements.  Please refer to the
  25.    current edition of the "IAB Official Protocol Standards" for the
  26.    standardization state and status of this protocol.  Distribution of
  27.    this memo is unlimited.
  28.  
  29. Table of Contents
  30.  
  31.    1. Abstract ..............................................    1
  32.    2. The Network Management Framework.......................    2
  33.    3. Objects ...............................................    2
  34.    3.1 Format of Definitions ...............................     3
  35.    4. Overview ..............................................    3
  36.    4.1 Scope of Definitions ................................     3
  37.    4.2 Textual Conventions .................................     3
  38.    5. Definitions ...........................................    4
  39.    6. Acknowledgements ......................................   21
  40.    7. References ............................................   22
  41.    8. Security Considerations................................   23
  42.    9. Authors' Addresses.....................................   23
  43.  
  44. 1.  Abstract
  45.  
  46.    This memo defines an experimental portion of the Management
  47.    Information Base (MIB) for use with network management protocols in
  48.    TCP/IP-based internets.  In particular, this memo defines managed
  49.    objects used for managing subnetworks which use the IEEE 802.5 Token
  50.    Ring technology described in 802.5 Token Ring Access Method and
  51.    Physical Layer Specifications, IEEE Standard 802.5-1989.
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58. Transmission Working Group                                      [Page 1]
  59.  
  60. RFC 1231                     IEEE 802.5 MIB                     May 1991
  61.  
  62.  
  63. 2.  The Network Management Framework
  64.  
  65.    The Internet-standard Network Management Framework consists of three
  66.    components.  They are:
  67.  
  68.       RFC 1155 which defines the SMI, the mechanisms used for describing
  69.       and naming objects for the purpose of management.  RFC 1212
  70.       defines a more concise description mechanism, which is wholly
  71.       consistent with the SMI.
  72.  
  73.       RFC 1156 which defines MIB-I, the core set of managed objects for
  74.       the Internet suite of protocols.  RFC 1213, defines MIB-II, an
  75.       evolution of MIB-I based on implementation experience and new
  76.       operational requirements.
  77.  
  78.       RFC 1157 which defines the SNMP, the protocol used for network
  79.       access to managed objects.
  80.  
  81.    The Framework permits new objects to be defined for the purpose of
  82.    experimentation and evaluation.
  83.  
  84. 3.  Objects
  85.  
  86.    Managed objects are accessed via a virtual information store, termed
  87.    the Management Information Base or MIB.  Objects in the MIB are
  88.    defined using the subset of Abstract Syntax Notation One (ASN.1) [7]
  89.    defined in the SMI.  In particular, each object has a name, a syntax,
  90.    and an encoding.  The name is an object identifier, an
  91.    administratively assigned name, which specifies an object type.  The
  92.    object type together with an object instance serves to uniquely
  93.    identify a specific instantiation of the object.  For human
  94.    convenience, we often use a textual string, termed the OBJECT
  95.    DESCRIPTOR, to also refer to the object type.
  96.  
  97.    The syntax of an object type defines the abstract data structure
  98.    corresponding to that object type.  The ASN.1 language is used for
  99.    this purpose.  However, the SMI [3] purposely restricts the ASN.1
  100.    constructs which may be used.  These restrictions are explicitly made
  101.    for simplicity.
  102.  
  103.    The encoding of an object type is simply how that object type is
  104.    represented using the object type's syntax.  Implicitly tied to the
  105.    notion of an object type's syntax and encoding is how the object type
  106.    is represented when being transmitted on the network.
  107.  
  108.    The SMI specifies the use of the basic encoding rules of ASN.1 [8],
  109.    subject to the additional requirements imposed by the SNMP.
  110.  
  111.  
  112.  
  113.  
  114. Transmission Working Group                                      [Page 2]
  115.  
  116. RFC 1231                     IEEE 802.5 MIB                     May 1991
  117.  
  118.  
  119. 3.1.  Format of Definitions
  120.  
  121.    Section 5 contains contains the specification of all object types
  122.    contained in this MIB module.  The object types are defined using the
  123.    conventions defined in the SMI, as amended by the extensions
  124.    specified in [9,10].
  125.  
  126. 4.  Overview
  127.  
  128.    This memo defines three tables: the 802.5 Interface Table, which
  129.    contains state and parameter information which is specific to 802.5
  130.    interfaces, the 802.5 Statistics Table, which contains 802.5
  131.    interface statistics, and the 802.5 Timer Table, which contains the
  132.    values of 802.5-defined timers. A managed system will have one entry
  133.    in the 802.5 Interface Table and one entry in the 802.5 Statistics
  134.    Table for each of its 802.5 interfaces.  Implementation of the 802.5
  135.    Timer Table is optional.
  136.  
  137.    This memo also defines OBJECT IDENTIFIERs, some to identify 802.5
  138.    tests, for use with the ifExtnsTestTable defined in [11], and some to
  139.    identify Token Ring interface Chip Sets, for use with the
  140.    ifExtnsChipSet object defined in [11].
  141.  
  142. 4.1.  Scope of Definitions
  143.  
  144.    All objects defined in this memo are registered in a single subtree
  145.    within the experimental namespace [3], and are for use with every
  146.    interface which conforms to the IEEE 802.5 Token Ring Access Method
  147.    and Physical Layer Specifications [10].  At present, this applies to
  148.    interfaces for which the ifType variable in the Internet-standard MIB
  149.    [4,6] has the value:
  150.  
  151.               iso88025-tokenRing(9)
  152.  
  153.    For these interfaces, the value of the ifSpecific variable in the
  154.    MIB-II [6] has the OBJECT IDENTIFIER value:
  155.  
  156.                dot5    OBJECT IDENTIFIER ::= { experimental 4 }
  157.  
  158.    as defined below.
  159.  
  160. 4.2.  Textual Conventions
  161.  
  162.    A new datatype, MacAddress, is introduced as a textual convention in
  163.    this document.  This textual convention has NO effect on either the
  164.    syntax nor the semantics of any managed object. Objects defined using
  165.    this convention are always encoded by means of the rules that define
  166.    their primitive type.  Hence, no changes to the SMI or the SNMP are
  167.  
  168.  
  169.  
  170. Transmission Working Group                                      [Page 3]
  171.  
  172. RFC 1231                     IEEE 802.5 MIB                     May 1991
  173.  
  174.  
  175.    necessary to accommodate this textual convention which is adopted
  176.    merely for the convenience of readers.
  177.  
  178. 5.  Definitions
  179.  
  180.  
  181.           RFC1231-MIB DEFINITIONS ::= BEGIN
  182.  
  183.           --                 IEEE 802.5 Token Ring MIB
  184.  
  185.           IMPORTS
  186.                   experimental
  187.                           FROM RFC1155-SMI
  188.                   OBJECT-TYPE
  189.                           FROM RFC-1212;
  190.  
  191.           --  This MIB Module uses the extended OBJECT-TYPE macro as
  192.           --  defined in [9].
  193.  
  194.  
  195.  
  196.           dot5    OBJECT IDENTIFIER ::= { experimental 4 }
  197.  
  198.           -- All representations of MAC addresses in this MIB Module
  199.           -- use, as a textual convention (i.e. this convention does
  200.           -- not affect their encoding), the data type:
  201.  
  202.           MacAddress ::= OCTET STRING (SIZE (6))    -- a 6 octet
  203.                                                     -- address in the
  204.                                                     -- "canonical" order
  205.           -- defined by IEEE 802.1a, i.e., as if it were transmitted
  206.           -- least significant bit first, even though 802.5 (in
  207.           -- contrast to other 802.x protocols) requires MAC addresses
  208.           -- to be transmitted most significant bit first.
  209.           --
  210.           -- 16-bit addresses, if needed, are represented by setting
  211.           -- their upper 4 octets to all 0's, i.e., AAFF would be
  212.           -- represented as 00000000AAFF.
  213.  
  214.  
  215.  
  216.           -- The Interface Table
  217.  
  218.           -- This table contains state and parameter information which
  219.           -- is specific to 802.5 interfaces.  It is mandatory that
  220.           -- systems having 802.5 interfaces implement this table in
  221.           -- addition to the generic interfaces table [4,6] and its
  222.           -- generic extensions [11].
  223.  
  224.  
  225.  
  226. Transmission Working Group                                      [Page 4]
  227.  
  228. RFC 1231                     IEEE 802.5 MIB                     May 1991
  229.  
  230.  
  231.           dot5Table  OBJECT-TYPE
  232.                      SYNTAX  SEQUENCE OF Dot5Entry
  233.                      ACCESS  not-accessible
  234.                      STATUS  mandatory
  235.                      DESCRIPTION
  236.                              "This table contains Token Ring interface
  237.                              parameters and state variables, one entry
  238.                              per 802.5 interface."
  239.                      ::= { dot5 1 }
  240.  
  241.           dot5Entry  OBJECT-TYPE
  242.                      SYNTAX  Dot5Entry
  243.                      ACCESS  not-accessible
  244.                      STATUS  mandatory
  245.                      DESCRIPTION
  246.                              "A list of Token Ring status and parameter
  247.                               values for an 802.5 interface."
  248.                      INDEX   { dot5IfIndex }
  249.                      ::= { dot5Table 1 }
  250.  
  251.           Dot5Entry
  252.               ::= SEQUENCE {
  253.                       dot5IfIndex
  254.                           INTEGER,
  255.                       dot5Commands
  256.                           INTEGER,
  257.                       dot5RingStatus
  258.                           INTEGER,
  259.                       dot5RingState
  260.                           INTEGER,
  261.                       dot5RingOpenStatus
  262.                           INTEGER,
  263.                       dot5RingSpeed
  264.                           INTEGER,
  265.                       dot5UpStream
  266.                           MacAddress,
  267.                       dot5ActMonParticipate
  268.                           INTEGER,
  269.                       dot5Functional
  270.                           MacAddress
  271.                   }
  272.  
  273.           dot5IfIndex  OBJECT-TYPE
  274.                      SYNTAX  INTEGER
  275.                      ACCESS  read-only
  276.                      STATUS  mandatory
  277.                      DESCRIPTION
  278.                              "The value of this object identifies the
  279.  
  280.  
  281.  
  282. Transmission Working Group                                      [Page 5]
  283.  
  284. RFC 1231                     IEEE 802.5 MIB                     May 1991
  285.  
  286.  
  287.                               802.5 interface for which this entry
  288.                               contains management information.  The
  289.                               value of this object for a particular
  290.                               interface has the same value as the
  291.                               ifIndex object, defined in [4,6],
  292.                               for the same interface."
  293.                      ::= { dot5Entry 1 }
  294.  
  295.           dot5Commands  OBJECT-TYPE
  296.                      SYNTAX  INTEGER {
  297.                                    no-op(1),
  298.                                    open(2),
  299.                                    reset(3),
  300.                                    close(4)
  301.                              }
  302.                      ACCESS  read-write
  303.                      STATUS  mandatory
  304.                      DESCRIPTION
  305.                              "When this object is set to the value of
  306.                               open(2), the station should go into the
  307.                               open state.  The progress and success of
  308.                               the open is given by the values of the
  309.                               objects dot5RingState and
  310.                               dot5RingOpenStatus.
  311.                                   When this object is set to the value
  312.                               of reset(3), then the station should do
  313.                               a reset.  On a reset, all MIB counters
  314.                               should retain their values, if possible.
  315.                               Other side affects are dependent on the
  316.                               hardware chip set.
  317.                                   When this object is set to the value
  318.                               of close(4), the station should go into
  319.                               the stopped state by removing itself
  320.                               from the ring.
  321.                                   Setting this object to a value of
  322.                               no-op(1) has no effect.
  323.                                   When read, this object always has a
  324.                               value of no-op(1)."
  325.                      ::= { dot5Entry 2 }
  326.  
  327.           dot5RingStatus OBJECT-TYPE
  328.                      SYNTAX  INTEGER
  329.                      ACCESS  read-only
  330.                      STATUS  mandatory
  331.                      DESCRIPTION
  332.                              "The current interface status which can
  333.                              be used to diagnose fluctuating problems
  334.                              that can occur on token rings, after a
  335.  
  336.  
  337.  
  338. Transmission Working Group                                      [Page 6]
  339.  
  340. RFC 1231                     IEEE 802.5 MIB                     May 1991
  341.  
  342.  
  343.                              station has successfully been added to
  344.                              the ring.
  345.                                 Before an open is completed, this
  346.                              object has the value for the 'no status'
  347.                              condition.  The dot5RingState and
  348.                              dot5RingOpenStatus objects provide for
  349.                              debugging problems when the station
  350.                              can not even enter the ring.
  351.                                  The object's value is a sum of
  352.                              values, one for each currently applicable
  353.                              condition.  The following values are
  354.                              defined for various conditions:
  355.  
  356.                                      0 = No Problems detected
  357.                                     32 = Ring Recovery
  358.                                     64 = Single Station
  359.                                    256 = Remove Received
  360.                                    512 = reserved
  361.                                   1024 = Auto-Removal Error
  362.                                   2048 = Lobe Wire Fault
  363.                                   4096 = Transmit Beacon
  364.                                   8192 = Soft Error
  365.                                  16384 = Hard Error
  366.                                  32768 = Signal Loss
  367.                                 131072 = no status, open not completed."
  368.                      ::= { dot5Entry 3 }
  369.  
  370.           dot5RingState  OBJECT-TYPE
  371.                      SYNTAX  INTEGER {
  372.                                    opened(1),
  373.                                    closed(2),
  374.                                    opening(3),
  375.                                    closing(4),
  376.                                    openFailure(5),
  377.                                    ringFailure(6)
  378.                              }
  379.                      ACCESS  read-only
  380.                      STATUS  mandatory
  381.                      DESCRIPTION
  382.                              "The current interface state with respect
  383.                              to entering or leaving the ring."
  384.                      ::= { dot5Entry 4 }
  385.  
  386.           dot5RingOpenStatus  OBJECT-TYPE
  387.                      SYNTAX  INTEGER {
  388.                                    noOpen(1),     -- no open attempted
  389.                                    badParam(2),
  390.                                    lobeFailed(3),
  391.  
  392.  
  393.  
  394. Transmission Working Group                                      [Page 7]
  395.  
  396. RFC 1231                     IEEE 802.5 MIB                     May 1991
  397.  
  398.  
  399.                                    signalLoss(4),
  400.                                    insertionTimeout(5),
  401.                                    ringFailed(6),
  402.                                    beaconing(7),
  403.                                    duplicateMAC(8),
  404.                                    requestFailed(9),
  405.                                    removeReceived(10),
  406.                                    open(11)      -- last open successful
  407.                              }
  408.                      ACCESS  read-only
  409.                      STATUS  mandatory
  410.                      DESCRIPTION
  411.                              "This object indicates the success, or the
  412.                              reason for failure, of the station's most
  413.                              recent attempt to enter the ring."
  414.                      ::= { dot5Entry 5 }
  415.  
  416.           dot5RingSpeed  OBJECT-TYPE
  417.                      SYNTAX  INTEGER {
  418.                                    unknown(1),
  419.                                    oneMegabit(2),
  420.                                    fourMegabit(3),
  421.                                    sixteenMegabit(4)
  422.                              }
  423.                      ACCESS  read-write
  424.                      STATUS  mandatory
  425.                      DESCRIPTION
  426.                              "The ring's bandwidth."
  427.                      ::= { dot5Entry 6 }
  428.  
  429.           dot5UpStream  OBJECT-TYPE
  430.                      SYNTAX  MacAddress
  431.                      ACCESS  read-only
  432.                      STATUS  mandatory
  433.                      DESCRIPTION
  434.                              "The MAC-address of the up stream neighbor
  435.                               station in the ring."
  436.                      ::= { dot5Entry 7 }
  437.  
  438.           dot5ActMonParticipate OBJECT-TYPE
  439.                      SYNTAX  INTEGER {
  440.                                    true(1),
  441.                                    false(2)
  442.                              }
  443.                      ACCESS  read-write
  444.                      STATUS  mandatory
  445.                      DESCRIPTION
  446.                              "If this object has a value of true(1) then
  447.  
  448.  
  449.  
  450. Transmission Working Group                                      [Page 8]
  451.  
  452. RFC 1231                     IEEE 802.5 MIB                     May 1991
  453.  
  454.  
  455.                              this interface will participate in the
  456.                              active monitor selection process.  If the
  457.                              value is false(2) then it will not.
  458.                              Setting this object might not have an
  459.                              effect until the next time the interface
  460.                              is opened."
  461.                      ::= { dot5Entry 8 }
  462.  
  463.           dot5Functional OBJECT-TYPE
  464.                      SYNTAX  MacAddress
  465.                      ACCESS  read-write
  466.                      STATUS  mandatory
  467.                      DESCRIPTION
  468.                              "The bit mask of all Token Ring functional
  469.                              addresses for which this interface will
  470.                              accept frames."
  471.                      ::= { dot5Entry 9 }
  472.  
  473.  
  474.  
  475.           --   The Statistics Table
  476.  
  477.           -- This table contains statistics and error counter which are
  478.           -- specific to 802.5 interfaces.  It is mandatory that systems
  479.           -- having 802.5 interfaces implement this table.
  480.  
  481.           dot5StatsTable  OBJECT-TYPE
  482.                      SYNTAX  SEQUENCE OF Dot5StatsEntry
  483.                      ACCESS  not-accessible
  484.                      STATUS  mandatory
  485.                      DESCRIPTION
  486.                              "A table containing Token Ring statistics,
  487.                              one entry per 802.5 interface.
  488.                                  All the statistics are defined using
  489.                              the syntax Counter as 32-bit wrap around
  490.                              counters.  Thus, if an interface's
  491.                              hardware maintains these statistics in
  492.                              16-bit counters, then the agent must read
  493.                              the hardware's counters frequently enough
  494.                              to prevent loss of significance, in order
  495.                              to maintain 32-bit counters in software."
  496.                      ::= { dot5 2 }
  497.  
  498.           dot5StatsEntry  OBJECT-TYPE
  499.                      SYNTAX  Dot5StatsEntry
  500.                      ACCESS  not-accessible
  501.                      STATUS  mandatory
  502.                      DESCRIPTION
  503.  
  504.  
  505.  
  506. Transmission Working Group                                      [Page 9]
  507.  
  508. RFC 1231                     IEEE 802.5 MIB                     May 1991
  509.  
  510.  
  511.                              "An entry contains the 802.5 statistics
  512.                               for a particular interface."
  513.                      INDEX   { dot5StatsIfIndex }
  514.                      ::= { dot5StatsTable 1 }
  515.  
  516.           Dot5StatsEntry
  517.               ::= SEQUENCE {
  518.                       dot5StatsIfIndex
  519.                           INTEGER,
  520.                       dot5StatsLineErrors
  521.                           Counter,
  522.                       dot5StatsBurstErrors
  523.                           Counter,
  524.                       dot5StatsACErrors
  525.                           Counter,
  526.                       dot5StatsAbortTransErrors
  527.                           Counter,
  528.                       dot5StatsInternalErrors
  529.                           Counter,
  530.                       dot5StatsLostFrameErrors
  531.                           Counter,
  532.                       dot5StatsReceiveCongestions
  533.                           Counter,
  534.                       dot5StatsFrameCopiedErrors
  535.                           Counter,
  536.                       dot5StatsTokenErrors
  537.                           Counter,
  538.                       dot5StatsSoftErrors
  539.                           Counter,
  540.                       dot5StatsHardErrors
  541.                           Counter,
  542.                       dot5StatsSignalLoss
  543.                           Counter,
  544.                       dot5StatsTransmitBeacons
  545.                           Counter,
  546.                       dot5StatsRecoverys
  547.                           Counter,
  548.                       dot5StatsLobeWires
  549.                           Counter,
  550.                       dot5StatsRemoves
  551.                           Counter,
  552.                       dot5StatsSingles
  553.                           Counter,
  554.                       dot5StatsFreqErrors
  555.                           Counter
  556.                   }
  557.  
  558.  
  559.  
  560.  
  561.  
  562. Transmission Working Group                                     [Page 10]
  563.  
  564. RFC 1231                     IEEE 802.5 MIB                     May 1991
  565.  
  566.  
  567.           dot5StatsIfIndex  OBJECT-TYPE
  568.                      SYNTAX  INTEGER
  569.                      ACCESS  read-only
  570.                      STATUS  mandatory
  571.                      DESCRIPTION
  572.                              "The value of this object identifies the
  573.                              802.5 interface for which this entry
  574.                              contains management information.  The
  575.                              value of this object for a particular
  576.                              interface has the same value as the
  577.                              ifIndex object, defined in [4,6], for
  578.                              the same interface."
  579.                      ::= { dot5StatsEntry 1 }
  580.  
  581.           dot5StatsLineErrors OBJECT-TYPE
  582.                      SYNTAX  Counter
  583.                      ACCESS  read-only
  584.                      STATUS  mandatory
  585.                      DESCRIPTION
  586.                              "This counter is incremented when a frame
  587.                              or token is copied or repeated by a
  588.                              station, the E bit is zero in the frame
  589.                              or token and one of the following
  590.                              conditions exists: 1) there is a
  591.                              non-data bit (J or K bit) between the SD
  592.                              and the ED of the frame or token, or
  593.                              2) there is an FCS error in the frame."
  594.                      ::= { dot5StatsEntry 2 }
  595.  
  596.           dot5StatsBurstErrors OBJECT-TYPE
  597.                      SYNTAX  Counter
  598.                      ACCESS  read-only
  599.                      STATUS  mandatory
  600.                      DESCRIPTION
  601.                              "This counter is incremented when a station
  602.                              detects the absence of transitions for five
  603.                              half-bit timers (burst-five error)."
  604.                      ::= { dot5StatsEntry 3 }
  605.  
  606.           dot5StatsACErrors OBJECT-TYPE
  607.                      SYNTAX  Counter
  608.                      ACCESS  read-only
  609.                      STATUS  mandatory
  610.                      DESCRIPTION
  611.                              "This counter is incremented when a station
  612.                              receives an AMP or SMP frame in which A is
  613.                              equal to C is equal to 0, and then receives
  614.                              another SMP frame with A is equal to C is
  615.  
  616.  
  617.  
  618. Transmission Working Group                                     [Page 11]
  619.  
  620. RFC 1231                     IEEE 802.5 MIB                     May 1991
  621.  
  622.  
  623.                              equal to 0 without first receiving an AMP
  624.                              frame. It denotes a station that cannot set
  625.                              the AC bits properly."
  626.                      ::= { dot5StatsEntry 4 }
  627.  
  628.           dot5StatsAbortTransErrors OBJECT-TYPE
  629.                      SYNTAX  Counter
  630.                      ACCESS  read-only
  631.                      STATUS  mandatory
  632.                      DESCRIPTION
  633.                              "This counter is incremented when a station
  634.                              transmits an abort delimiter while
  635.                              transmitting."
  636.                      ::= { dot5StatsEntry 5 }
  637.  
  638.           dot5StatsInternalErrors OBJECT-TYPE
  639.                      SYNTAX  Counter
  640.                      ACCESS  read-only
  641.                      STATUS  mandatory
  642.                      DESCRIPTION
  643.                              "This counter is incremented when a station
  644.                              recognizes an internal error."
  645.                      ::= { dot5StatsEntry 6 }
  646.  
  647.           dot5StatsLostFrameErrors OBJECT-TYPE
  648.                      SYNTAX  Counter
  649.                      ACCESS  read-only
  650.                      STATUS  mandatory
  651.                      DESCRIPTION
  652.                              "This counter is incremented when a station
  653.                              is transmitting and its TRR timer expires.
  654.                              This condition denotes a condition where a
  655.                              transmitting station in strip mode does not
  656.                              receive the trailer of the frame before the
  657.                              TRR timer goes off."
  658.                      ::= { dot5StatsEntry 7 }
  659.  
  660.           dot5StatsReceiveCongestions OBJECT-TYPE
  661.                      SYNTAX  Counter
  662.                      ACCESS  read-only
  663.                      STATUS  mandatory
  664.                      DESCRIPTION
  665.                              "This counter is incremented when a station
  666.                              recognizes a frame addressed to its
  667.                              specific address, but has no available
  668.                              buffer space indicating that the station
  669.                              is congested."
  670.                      ::= { dot5StatsEntry 8 }
  671.  
  672.  
  673.  
  674. Transmission Working Group                                     [Page 12]
  675.  
  676. RFC 1231                     IEEE 802.5 MIB                     May 1991
  677.  
  678.  
  679.           dot5StatsFrameCopiedErrors OBJECT-TYPE
  680.                      SYNTAX  Counter
  681.                      ACCESS  read-only
  682.                      STATUS  mandatory
  683.                      DESCRIPTION
  684.                              "This counter is incremented when a station
  685.                              recognizes a frame addressed to its
  686.                              specific address and detects that the FS
  687.                              field A bits are set to 1 indicating a
  688.                              possible line hit or duplicate address."
  689.                      ::= { dot5StatsEntry 9 }
  690.  
  691.           dot5StatsTokenErrors OBJECT-TYPE
  692.                      SYNTAX  Counter
  693.                      ACCESS  read-only
  694.                      STATUS  mandatory
  695.                      DESCRIPTION
  696.                              "This counter is incremented when a station
  697.                              acting as the active monitor recognizes an
  698.                              error condition that needs a token
  699.                              transmitted."
  700.                      ::= { dot5StatsEntry 10 }
  701.  
  702.           dot5StatsSoftErrors OBJECT-TYPE
  703.                      SYNTAX  Counter
  704.                      ACCESS  read-only
  705.                      STATUS  mandatory
  706.                      DESCRIPTION
  707.                              "The number of Soft Errors the interface
  708.                              has detected. It directly corresponds to
  709.                              the number of Report Error MAC frames
  710.                              that this interface has transmitted.
  711.                              Soft Errors are those which are
  712.                              recoverable by the MAC layer protocols."
  713.                      ::= { dot5StatsEntry 11 }
  714.  
  715.           dot5StatsHardErrors OBJECT-TYPE
  716.                      SYNTAX  Counter
  717.                      ACCESS  read-only
  718.                      STATUS  mandatory
  719.                      DESCRIPTION
  720.                              "The number of times this interface has
  721.                              detected an immediately recoverable
  722.                              fatal error.  It denotes the number of
  723.                              times this interface is either
  724.                              transmitting or receiving beacon MAC
  725.                              frames."
  726.                      ::= { dot5StatsEntry 12 }
  727.  
  728.  
  729.  
  730. Transmission Working Group                                     [Page 13]
  731.  
  732. RFC 1231                     IEEE 802.5 MIB                     May 1991
  733.  
  734.  
  735.           dot5StatsSignalLoss OBJECT-TYPE
  736.                      SYNTAX  Counter
  737.                      ACCESS  read-only
  738.                      STATUS  mandatory
  739.                      DESCRIPTION
  740.                              "The number of times this interface has
  741.                              detected the loss of signal condition from
  742.                              the ring."
  743.                      ::= { dot5StatsEntry 13 }
  744.  
  745.           dot5StatsTransmitBeacons OBJECT-TYPE
  746.                      SYNTAX  Counter
  747.                      ACCESS  read-only
  748.                      STATUS  mandatory
  749.                      DESCRIPTION
  750.                              "The number of times this interface has
  751.                              transmitted a beacon frame."
  752.                      ::= { dot5StatsEntry 14 }
  753.  
  754.           dot5StatsRecoverys OBJECT-TYPE
  755.                      SYNTAX  Counter
  756.                      ACCESS  read-only
  757.                      STATUS  mandatory
  758.                      DESCRIPTION
  759.                              "The number of Claim Token MAC frames
  760.                              received or transmitted after the interface
  761.                              has received a Ring Purge MAC frame.  This
  762.                              counter signifies the number of times the
  763.                              ring has been purged and is being recovered
  764.                              back into a normal operating state."
  765.                      ::= { dot5StatsEntry 15 }
  766.  
  767.           dot5StatsLobeWires OBJECT-TYPE
  768.                      SYNTAX  Counter
  769.                      ACCESS  read-only
  770.                      STATUS  mandatory
  771.                      DESCRIPTION
  772.                              "The number of times the interface has
  773.                              detected an open or short circuit in the
  774.                              lobe data path.  The adapter will be closed
  775.                              and dot5RingState will signify this
  776.                              condition."
  777.                      ::= { dot5StatsEntry 16 }
  778.  
  779.           dot5StatsRemoves OBJECT-TYPE
  780.                      SYNTAX  Counter
  781.                      ACCESS  read-only
  782.                      STATUS  mandatory
  783.  
  784.  
  785.  
  786. Transmission Working Group                                     [Page 14]
  787.  
  788. RFC 1231                     IEEE 802.5 MIB                     May 1991
  789.  
  790.  
  791.                      DESCRIPTION
  792.                              "The number of times the interface has
  793.                              received a Remove Ring Station MAC frame
  794.                              request.  When this frame is received
  795.                              the interface will enter the close state
  796.                              and dot5RingState will signify this
  797.                              condition."
  798.                      ::= { dot5StatsEntry 17 }
  799.  
  800.           dot5StatsSingles OBJECT-TYPE
  801.                      SYNTAX  Counter
  802.                      ACCESS  read-only
  803.                      STATUS  mandatory
  804.                      DESCRIPTION
  805.                              "The number of times the interface has
  806.                              sensed that it is the only station on the
  807.                              ring.  This will happen if the interface
  808.                              is the first one up on a ring, or if
  809.                              there is a hardware problem."
  810.                      ::= { dot5StatsEntry 18 }
  811.  
  812.           dot5StatsFreqErrors OBJECT-TYPE
  813.                      SYNTAX  Counter
  814.                      ACCESS  read-only
  815.                      STATUS  optional
  816.                      DESCRIPTION
  817.                              "The number of times the interface has
  818.                              detected that the frequency of the
  819.                              incoming signal differs from the expected
  820.                              frequency by more than that specified by
  821.                              the IEEE 802.5 standard, see chapter 7
  822.                              in [10]."
  823.                      ::= { dot5StatsEntry 19 }
  824.  
  825.  
  826.           -- The Timer Table
  827.  
  828.           -- This group contains the values of the timers defined in
  829.           -- [10] for 802.5 interfaces.  It is optional that systems
  830.           -- having 802.5 interfaces implement this group.
  831.  
  832.           dot5TimerTable  OBJECT-TYPE
  833.                      SYNTAX  SEQUENCE OF Dot5TimerEntry
  834.                      ACCESS  not-accessible
  835.                      STATUS  mandatory
  836.                      DESCRIPTION
  837.                              "This table contains Token Ring interface
  838.                              timer values, one entry per 802.5
  839.  
  840.  
  841.  
  842. Transmission Working Group                                     [Page 15]
  843.  
  844. RFC 1231                     IEEE 802.5 MIB                     May 1991
  845.  
  846.  
  847.                              interface."
  848.                      ::= { dot5 5 }
  849.  
  850.           dot5TimerEntry  OBJECT-TYPE
  851.                      SYNTAX  Dot5TimerEntry
  852.                      ACCESS  not-accessible
  853.                      STATUS  mandatory
  854.                      DESCRIPTION
  855.                              "A list of Token Ring timer values for an
  856.                              802.5 interface."
  857.                      INDEX   { dot5TimerIfIndex }
  858.                      ::= { dot5TimerTable 1 }
  859.  
  860.           Dot5TimerEntry
  861.               ::= SEQUENCE {
  862.                      dot5TimerIfIndex
  863.                          INTEGER,
  864.                      dot5TimerReturnRepeat
  865.                          INTEGER,
  866.                      dot5TimerHolding
  867.                          INTEGER,
  868.                      dot5TimerQueuePDU
  869.                          INTEGER,
  870.                      dot5TimerValidTransmit
  871.                          INTEGER,
  872.                      dot5TimerNoToken
  873.                          INTEGER,
  874.                      dot5TimerActiveMon
  875.                          INTEGER,
  876.                      dot5TimerStandbyMon
  877.                          INTEGER,
  878.                      dot5TimerErrorReport
  879.                          INTEGER,
  880.                      dot5TimerBeaconTransmit
  881.                          INTEGER,
  882.                      dot5TimerBeaconReceive
  883.                          INTEGER
  884.                  }
  885.  
  886.           dot5TimerIfIndex  OBJECT-TYPE
  887.                      SYNTAX  INTEGER
  888.                      ACCESS  read-only
  889.                      STATUS  mandatory
  890.                      DESCRIPTION
  891.                              "The value of this object identifies the
  892.                               802.5 interface for which this entry
  893.                               contains timer values.  The value of
  894.                               this object for a particular interface
  895.  
  896.  
  897.  
  898. Transmission Working Group                                     [Page 16]
  899.  
  900. RFC 1231                     IEEE 802.5 MIB                     May 1991
  901.  
  902.  
  903.                               has the same value as the ifIndex
  904.                               object, defined in [4,6], for the same
  905.                               interface."
  906.                      ::= { dot5TimerEntry 1 }
  907.  
  908.           dot5TimerReturnRepeat  OBJECT-TYPE
  909.                      SYNTAX  INTEGER
  910.                      ACCESS  read-only
  911.                      STATUS  mandatory
  912.                      DESCRIPTION
  913.                              "The time-out value used to ensure the
  914.                              interface will return to Repeat State, in
  915.                              units of 100 micro-seconds.  The value
  916.                              should be greater than the maximum ring
  917.                              latency.
  918.                                  Implementors are encouraged to provide
  919.                              read-write access to this object if that is
  920.                              possible/useful in their system, but giving
  921.                              due consideration to the dangers of
  922.                              write-able timers."
  923.                      ::= { dot5TimerEntry 2 }
  924.  
  925.           dot5TimerHolding  OBJECT-TYPE
  926.                      SYNTAX  INTEGER
  927.                      ACCESS  read-only
  928.                      STATUS  mandatory
  929.                      DESCRIPTION
  930.                              "Maximum period of time a station is
  931.                              permitted to transmit frames after capturing
  932.                              a token, in units of 100 micro-seconds.
  933.                                  Implementors are encouraged to provide
  934.                              read-write access to this object if that is
  935.                              possible/useful in their system, but giving
  936.                              due consideration to the dangers of
  937.                              write-able timers."
  938.                      ::= { dot5TimerEntry 3 }
  939.  
  940.           dot5TimerQueuePDU  OBJECT-TYPE
  941.                      SYNTAX  INTEGER
  942.                      ACCESS  read-only
  943.                      STATUS  mandatory
  944.                      DESCRIPTION
  945.                              "The time-out value for enqueuing of an SMP
  946.                              PDU after reception of an AMP or SMP
  947.                              frame in which the A and C bits were
  948.                              equal to 0, in units of 100
  949.                              micro-seconds.
  950.                                  Implementors are encouraged to provide
  951.  
  952.  
  953.  
  954. Transmission Working Group                                     [Page 17]
  955.  
  956. RFC 1231                     IEEE 802.5 MIB                     May 1991
  957.  
  958.  
  959.                              read-write access to this object if that is
  960.                              possible/useful in their system, but giving
  961.                              due consideration to the dangers of
  962.                              write-able timers."
  963.                      ::= { dot5TimerEntry 4 }
  964.  
  965.           dot5TimerValidTransmit OBJECT-TYPE
  966.                      SYNTAX  INTEGER
  967.                      ACCESS  read-only
  968.                      STATUS  mandatory
  969.                      DESCRIPTION
  970.                              "The time-out value used by the active
  971.                              monitor to detect the absence of valid
  972.                              transmissions, in units of 100
  973.                              micro-seconds.
  974.                                  Implementors are encouraged to provide
  975.                              read-write access to this object if that is
  976.                              possible/useful in their system, but giving
  977.                              due consideration to the dangers of
  978.                              write-able timers."
  979.                      ::= { dot5TimerEntry 5 }
  980.  
  981.           dot5TimerNoToken  OBJECT-TYPE
  982.                      SYNTAX  INTEGER
  983.                      ACCESS  read-only
  984.                      STATUS  mandatory
  985.                      DESCRIPTION
  986.                              "The time-out value used to recover from
  987.                              various-related error situations [9].
  988.                              If N is the maximum number of stations on
  989.                              the ring, the value of this timer is
  990.                              normally:
  991.                              dot5TimerReturnRepeat + N*dot5TimerHolding.
  992.                                  Implementors are encouraged to provide
  993.                              read-write access to this object if that is
  994.                              possible/useful in their system, but giving
  995.                              due consideration to the dangers of
  996.                              write-able timers."
  997.                      ::= { dot5TimerEntry 6 }
  998.  
  999.           dot5TimerActiveMon  OBJECT-TYPE
  1000.                      SYNTAX  INTEGER
  1001.                      ACCESS  read-only
  1002.                      STATUS  mandatory
  1003.                      DESCRIPTION
  1004.                              "The time-out value used by the active
  1005.                              monitor to stimulate the enqueuing of an
  1006.                              AMP PDU for transmission, in units of
  1007.  
  1008.  
  1009.  
  1010. Transmission Working Group                                     [Page 18]
  1011.  
  1012. RFC 1231                     IEEE 802.5 MIB                     May 1991
  1013.  
  1014.  
  1015.                              100 micro-seconds.
  1016.                                  Implementors are encouraged to provide
  1017.                              read-write access to this object if that is
  1018.                              possible/useful in their system, but giving
  1019.                              due consideration to the dangers of
  1020.                              write-able timers."
  1021.                      ::= { dot5TimerEntry 7 }
  1022.  
  1023.           dot5TimerStandbyMon  OBJECT-TYPE
  1024.                      SYNTAX  INTEGER
  1025.                      ACCESS  read-only
  1026.                      STATUS  mandatory
  1027.                      DESCRIPTION
  1028.                              "The time-out value used by the stand-by
  1029.                              monitors to ensure that there is an active
  1030.                              monitor on the ring and to detect a
  1031.                              continuous stream of tokens, in units of
  1032.                              100 micro-seconds.
  1033.                                  Implementors are encouraged to provide
  1034.                              read-write access to this object if that is
  1035.                              possible/useful in their system, but giving
  1036.                              due consideration to the dangers of
  1037.                              write-able timers."
  1038.                      ::= { dot5TimerEntry 8 }
  1039.  
  1040.           dot5TimerErrorReport  OBJECT-TYPE
  1041.                      SYNTAX  INTEGER
  1042.                      ACCESS  read-only
  1043.                      STATUS  mandatory
  1044.                      DESCRIPTION
  1045.                              "The time-out value which determines how
  1046.                              often a station shall send a Report Error
  1047.                              MAC frame to report its error counters,
  1048.                              in units of 100 micro-seconds.
  1049.                                  Implementors are encouraged to provide
  1050.                              read-write access to this object if that is
  1051.                              possible/useful in their system, but giving
  1052.                              due consideration to the dangers of
  1053.                              write-able timers."
  1054.                      ::= { dot5TimerEntry 9 }
  1055.  
  1056.           dot5TimerBeaconTransmit  OBJECT-TYPE
  1057.                      SYNTAX  INTEGER
  1058.                      ACCESS  read-only
  1059.                      STATUS  mandatory
  1060.                      DESCRIPTION
  1061.                              "The time-out value which determines how
  1062.                              long a station shall remain in the state
  1063.  
  1064.  
  1065.  
  1066. Transmission Working Group                                     [Page 19]
  1067.  
  1068. RFC 1231                     IEEE 802.5 MIB                     May 1991
  1069.  
  1070.  
  1071.                              of transmitting Beacon frames before
  1072.                              entering the Bypass state, in units of
  1073.                              100 micro-seconds.
  1074.                                  Implementors are encouraged to provide
  1075.                              read-write access to this object if that is
  1076.                              possible/useful in their system, but giving
  1077.                              due consideration to the dangers of
  1078.                              write-able timers."
  1079.                      ::= { dot5TimerEntry 10 }
  1080.  
  1081.           dot5TimerBeaconReceive  OBJECT-TYPE
  1082.                      SYNTAX  INTEGER
  1083.                      ACCESS  read-only
  1084.                      STATUS  mandatory
  1085.                      DESCRIPTION
  1086.                              "The time-out value which determines how
  1087.                              long a station shall receive Beacon
  1088.                              frames from its downstream neighbor
  1089.                              before entering the Bypass state, in
  1090.                              units of 100 micro-seconds.
  1091.                                  Implementors are encouraged to provide
  1092.                              read-write access to this object if that is
  1093.                              possible/useful in their system, but giving
  1094.                              due consideration to the dangers of
  1095.                              write-able timers."
  1096.                      ::= { dot5TimerEntry 11 }
  1097.  
  1098.  
  1099.           --                      802.5 Interface Tests
  1100.  
  1101.           dot5Tests         OBJECT IDENTIFIER ::= { dot5 3 }
  1102.  
  1103.           -- The extensions to the interfaces table proposed in [11]
  1104.           -- define a table object, ifExtnsTestTable, through which a
  1105.           -- network manager can instruct an agent to test an interface
  1106.           -- for various faults.  A test to be performed is identified
  1107.           -- (as the value of ifExtnsTestType) via an OBJECT IDENTIFIER.
  1108.           --
  1109.           -- The Full-Duplex Loop Back Test is a common test, defined
  1110.           -- in [11] as:
  1111.           --
  1112.           --    testFullDuplexLoopBack
  1113.           --
  1114.           -- Invoking this test on a 802.5 interface causes the
  1115.           -- interface to check the path from memory through the
  1116.           -- chip set's internal logic and back to memory, thus
  1117.           -- checking the proper functioning of the systems's
  1118.           -- interface to the chip set.
  1119.  
  1120.  
  1121.  
  1122. Transmission Working Group                                     [Page 20]
  1123.  
  1124. RFC 1231                     IEEE 802.5 MIB                     May 1991
  1125.  
  1126.  
  1127.           -- The Insert Function test is defined by:
  1128.  
  1129.           testInsertFunc    OBJECT IDENTIFIER ::= { dot5Tests 1 }
  1130.  
  1131.           -- Invoking this test causes the station to test the insert
  1132.           -- ring logic of the hardware if the station's lobe media
  1133.           -- cable is connected to a wiring concentrator.  Note that
  1134.           -- this command inserts the station into the network, and
  1135.           -- thus, could cause problems if the station is connected
  1136.           -- to a operational network.
  1137.  
  1138.           --                 802.5 Hardware Chip Sets
  1139.  
  1140.           dot5ChipSets   OBJECT IDENTIFIER ::= { dot5 4 }
  1141.  
  1142.           -- The extensions to the interfaces table proposed in [11]
  1143.           -- define an object, ifExtnsChipSet, with the syntax of
  1144.           -- OBJECT IDENTIFIER, to identify the hardware chip set in
  1145.           -- use by an interface.  That definition specifies just
  1146.           -- one applicable object identifier:
  1147.           --
  1148.           --    unknownChipSet
  1149.           --
  1150.           -- for use as the value of ifExtnsChipSet when the specific
  1151.           -- chip set is unknown.
  1152.           --
  1153.           -- This MIB defines the following for use as values of
  1154.           -- ifExtnsChipSet:
  1155.  
  1156.              -- IBM 16/4 Mb/s
  1157.           chipSetIBM16       OBJECT IDENTIFIER ::= { dot5ChipSets 1 }
  1158.  
  1159.              -- TI 4Mb/s
  1160.           chipSetTItms380    OBJECT IDENTIFIER ::= { dot5ChipSets 2 }
  1161.  
  1162.              -- TI 16/4 Mb/s
  1163.           chipSetTItms380c16 OBJECT IDENTIFIER ::= { dot5ChipSets 3 }
  1164.  
  1165.           END
  1166.  
  1167. 6.  Acknowledgements
  1168.  
  1169.    This document was produced under the auspices of the IETF's
  1170.    Transmission Working Group.  The comments of the following
  1171.    individuals are acknowledged:
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178. Transmission Working Group                                     [Page 21]
  1179.  
  1180. RFC 1231                     IEEE 802.5 MIB                     May 1991
  1181.  
  1182.  
  1183.          Tom Benkart, Advanced Computer Communications
  1184.          Stan Froyd, Advanced Computer Communications
  1185.          Marshall T. Rose, Performance Systems International, Inc.
  1186.  
  1187. 7.  References
  1188.  
  1189.    [1] Cerf, V., "IAB Recommendations for the Development of Internet
  1190.        Network Management Standards", RFC 1052, NRI, April 1988.
  1191.  
  1192.    [2] Cerf, V., "Report of the Second Ad Hoc Network Management Review
  1193.        Group", RFC 1109, NRI, August 1989.
  1194.  
  1195.    [3] Rose M., and K. McCloghrie, "Structure and Identification of
  1196.        Management Information for TCP/IP-based internets", RFC 1155,
  1197.        Performance Systems International, Hughes LAN Systems, May 1990.
  1198.  
  1199.    [4] McCloghrie K., and M. Rose, "Management Information Base for
  1200.        Network Management of TCP/IP-based internets", RFC 1156, Hughes
  1201.        LAN Systems, Performance Systems International, May 1990.
  1202.  
  1203.    [5] Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple
  1204.        Network Management Protocol (SNMP), RFC 1157, SNMP Research,
  1205.        Performance Systems International, Performance Systems
  1206.        International, MIT Laboratory for Computer Science, May 1990.
  1207.  
  1208.    [6] McCloghrie K., and M. Rose, Editors, "Management Information Base
  1209.        for Network Management of TCP/IP-based internets", RFC 1213,
  1210.        Performance Systems International, March 1991.
  1211.  
  1212.    [7] Information processing systems - Open Systems Interconnection -
  1213.        Specification of Abstract Syntax Notation One (ASN.1),
  1214.        International Organization for Standardization, International
  1215.        Standard 8824, December 1987.
  1216.  
  1217.    [8] Information processing systems - Open Systems Interconnection -
  1218.        Specification of Basic Encoding Rules for Abstract Notation One
  1219.        (ASN.1), International Organization for Standardization,
  1220.        International Standard 8825, December 1987.
  1221.  
  1222.    [9] Rose, M., and K. McCloghrie, Editors, "Concise MIB Definitions",
  1223.        RFC 1212, Performance Systems International, Hughes LAN Systems,
  1224.        March 1991.
  1225.  
  1226.   [10] Token Ring Access Method and Physical Layer Specifications,
  1227.        Institute of Electrical and Electronic Engineers, IEEE Standard
  1228.        802.5-1989, 1989.
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234. Transmission Working Group                                     [Page 22]
  1235.  
  1236. RFC 1231                     IEEE 802.5 MIB                     May 1991
  1237.  
  1238.  
  1239.   [11] McCloghrie, K., Editor, "Extensions to the Generic-Interface
  1240.        MIB", RFC 1229, Hughes LAN Systems, May 1991.
  1241.  
  1242. 8.  Security Considerations
  1243.  
  1244.    Security issues are not discussed in this memo.
  1245.  
  1246. 9.  Authors' Addresses
  1247.  
  1248.    Keith McCloghrie
  1249.    Hughes LAN Systems, Inc.
  1250.    1225 Charleston Road
  1251.    Mountain View, CA 94043
  1252.  
  1253.    Phone: (415) 966-7934
  1254.    EMail: kzm@hls.com
  1255.  
  1256.  
  1257.    Richard Fox
  1258.    Synoptics, Inc.
  1259.    4401 Great America Pkwy
  1260.    PO Box 58185
  1261.    Santa Clara, Cal. 95052
  1262.  
  1263.    Phone: (408) 764-1372
  1264.    EMail: rfox@synoptics.com
  1265.  
  1266.  
  1267.    Eric Decker
  1268.    cisco Systems, Inc.
  1269.    1525 O'Brien Dr.
  1270.    Menlo Park, CA 94025
  1271.  
  1272.    Phone: (415) 688-8241
  1273.    EMail: cire@cisco.com
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290. Transmission Working Group                                     [Page 23]
  1291.